v4.3.0

Compare Source

Minor Changes

• eed8328: feat: adapt colors and icons from original GitHub alerts syntax

  feat: new Callout type important

  fix: inconsistent built-in Callout's icons size

  feat: improve Callout's accessibility colors

• 0831a1b: Add an onSearch callback to the <Search /> component. This
  callback, when specified, is called upon every search input change.

• c93fc48: update zod to v4

  feat(TSDoc): rename generateDocumentation to generateDefinition

  feat(Bleed): pass all props from div element to Bleed, Callout, Banner
  container

  fix(TSDoc): improve TSDoc comments for components

  • Banner
  • Head
  • Search
  • Bleed
  • Callout
  • Cards
  • FileTree
  • Steps
  • Table
  • Tabs
  • Playground
  • TSDoc
  • Layout
  • Navbar

  fix(TSDoc): improve TSDoc comments for functions:

  • nextra
  • generateDefinition
  • useMDXComponents

• 94b081c: feat: refactor <Search> component styles for improved transitions
  and visibility

• b5fab80: add MDXRemote component docs page
  https://nextra.site/docs/built-ins/mdxremote

• d9dd061: update tailwindcss to 4.1.10 and react-compiler-runtime to
  19.1.0-rc.2

• c134abe: feat: improve overall accessibility, makes text/colors easier to read
  and achieves WCAG Level AAA compliance in many places

• 83f6c57: feat: introduce new <TSDoc /> component

  The <TSDoc> component from nextra/tsdoc generates a properties table that
  displays:

  • Property name
  • TypeScript type
  • Property description - is parsed from TSDoc inline
    description or the @description tag. You can use any Markdown/MDX syntax
    here.
  • Default value - are extracted from the @default or @defaultValue
    tag.
  • Permalink - a # anchor link to the property row for easy reference.

  More info can be found in https://nextra.site/docs/built-ins/tsdoc

  [!IMPORTANT]

  Huge thanks to
  xyflow - Node Based UIs for React and Svelte
  for sponsoring this feature!

• 07debf9: feat(TSDoc): support flattening return object fields

• fdeb5fe: feat: add new Layout prop feedback.link to customize feedback href

Patch Changes

• 71f7b3f: Update https://nextra.site/docs/guide/search page

  Fixes extra margin-top inside Tabs.Tab

  Fix breaking <Steps> component numeration when there is <Tabs> component
  inside

• a070fdc: Fix [object Object] text on hovering breadcrumbs and pagination
  links

• 47ba5f3: fix: use em for padding-y, padding-x and border-radius styles of
  <Code> element

  fix(TSDoc): for return signature without name return mobile card instead of
  table

  feat: use em instead rem for margins

• 40267dc: split TSDoc component logic to TSDoc component and
  generateDocumentation function

  update https://nextra.site/docs/built-ins/tsdoc documentation

• b0dde33: Fix collapse behaviour of sidebar

  • When a nested route item is active, clicking the parent route item should
    not collapse the section.
  • When the collapsible section is open, clicking the parent route item should
    not cause it to collapse.
  • Switching to another route should not trigger an unexpected reopening.

• 8ac2506: chore: bump babel-plugin-react-compiler and
  react-compiler-runtime, remove custom pnpm patch for
  babel-plugin-react-compiler

• 8edc715: fix phantom scroll when footer is disabled

• b2cba90: improve TSDoc comments for getPageMap, generateStaticParamsFor
  and importPage functions. Add new https://nextra.site/docs/guide/api page.

• d29469e: support Next.js 15.3.0

• 2b18c66: - Disable prefetch for sidebar/breadcrumb/pagination links

  • Add extractStringsFromReactNode to extract strings from breadcrumb links and
    pagination links

• 6a82e6f: - Fix: Received false for a non-boolean attribute prefetch.

  • Allow override next-mdx-import-source-file in turbopack.resolveAlias
    option

• 4547eb9: feat(TSDoc): add support for functions and functions with multiple
  signatures

• 407e0c4: feat(TSDoc): add TSDoc.noParametersContent prop

• a506e0b: fix TypeError: page.generateMetadata is not a function when using
  with withSentryConfig plugin

• Updated dependencies [eed8328]

• Updated dependencies [71f7b3f]

• Updated dependencies [0831a1b]

• Updated dependencies [b0afee7]

• Updated dependencies [c93fc48]

• Updated dependencies [47ba5f3]

• Updated dependencies [01ac538]

• Updated dependencies [94b081c]

• Updated dependencies [b5fab80]

• Updated dependencies [40267dc]

• Updated dependencies [ef35ab9]

• Updated dependencies [f717156]

• Updated dependencies [9f449e5]

• Updated dependencies [8ac2506]

• Updated dependencies [a6a1f97]

• Updated dependencies [fda0355]

• Updated dependencies [b2cba90]

• Updated dependencies [f40e018]

• Updated dependencies [d29469e]

• Updated dependencies [d9dd061]

• Updated dependencies [6a82e6f]

• Updated dependencies [c134abe]

• Updated dependencies [7de40fb]

• Updated dependencies [c7d25df]

• Updated dependencies [4547eb9]

• Updated dependencies [407e0c4]

• Updated dependencies [83f6c57]

• Updated dependencies [00f4696]

• Updated dependencies [31ddba4]

• Updated dependencies [07debf9]

• Updated dependencies [a506e0b]

• Updated dependencies [9690841]

  • [email protected]

v4.2.17

Compare Source

Patch Changes

• a7db0e6: fix: use correct ReactNode zod validation for Layout.footer/banner/editLink/feedback.content/toc.backToTop/toc.extraContent/toc.title/search and Navbar.children/projectIcon/chatIcon
• 18e7fb9: fix: allow override NextraConfig.mdxOptions.format option in next.config file

v4.2.16

Compare Source

Patch Changes

• 2cfaacc: fix: frozen spinner on loading state in search results by updating Tailwind CSS to v4.0.10

v4.2.15

Compare Source

Patch Changes

• 5617e04: fix: loading state in search results was only visible during the first search

v4.2.14

Compare Source

Patch Changes

• ccb5da2: removing custom nextra's scrollbar styles, allowing the browser's default scrollbars to be used
• 05a202d: fix: make search results appear above the navbar

v4.2.13

Compare Source

Patch Changes

• fc4035c: add code block icon for svelte language
• fc4035c: increase z-index for banner to 30 to fix hidden banner when mobile nav is open

v4.2.12

Compare Source

v4.2.11

Compare Source

Patch Changes

• 8805d3f: - add overflow: hidden on <html> element instead of <body> to lock scroll when mobile nav is open
  • increase z-index for mobile nav from 10 to 20, in navbar from 20 to 30
  • fix navbar alignement on mobile when Navbar.align prop is set to left
  • [email protected]

v4.2.10

Compare Source

Patch Changes

• 5c22495: - add Navbar.align prop to align navigation links to the specified side. (default 'right')
  • fix hidden nav links when specified with type: 'page', href: '...' in _meta files

v4.2.9

Compare Source

Patch Changes

• 31534cb: add Navbar.className prop
  • [email protected]

v4.2.8

Compare Source

Patch Changes

• e610d1d: fix type of Navbar.children, should be ReactNode, not ReactElement
  • [email protected]

v4.2.7

Compare Source

v4.2.6

Compare Source

Patch Changes

• Updated dependencies [a7906d1]
  • [email protected]

v4.2.5

Compare Source

Patch Changes

• Updated dependencies [e6c3050]
  • [email protected]

v4.2.4

Compare Source

Patch Changes

• Updated dependencies [b46d831]
• Updated dependencies [7949e28]
  • [email protected]

v4.2.3

Compare Source

Patch Changes

• ca67a19: remove requirement page.{jsx,tsx} pages to have exported metadata object

v4.2.2

Compare Source

Patch Changes

• Updated dependencies [dd32eca]
  • [email protected]

v4.2.1

Compare Source

Patch Changes

• 5c51b49: fix allow configuring theme.toc in _meta file when toc.float is set to false for pages with type: 'page'
• 996b0b5: fix: show Scroll to top link toc.backToTop when toc.float: false is set
  • [email protected]

v4.2.0

Compare Source

Minor Changes

• 90b8c66: allow configuring theme.toc with layout: 'default' in _meta files

Patch Changes

• 0b0db89: better animations for open/closed state for the <NavbarMenu> component which is rendered with type: 'menu' in _meta file
• 427b080: calculate --nextra-banner-height after mounting banner, so banner text can be wrapped on multiple lines
• 6b8053f: fix a sudden height jump on opening for <detail> element when his last children contain margins
• 5d1e75b: add the missing transition-opacity style for the <BackToTop> component
• b0e686e: hide default <summary> arrow on mobile
• 2b0b434: add the missing cursor-pointer style in the <BackToTop> component
• bcc34cc: reduce main area padding x to from 24px to 16px like in next.js docs
• Updated dependencies [427b080]
• Updated dependencies [6b8053f]
• Updated dependencies [b0e686e]
  • [email protected]

v4.1.1

Compare Source

Patch Changes

• b9f8bfb: do not render default footer content if the Footer#children prop was not provided
• 8d878dd: fix: show heading anchor when hover on heading itself
• 20f7aaa: fix Uncaught Error: Minified React error #​418; visit https://react.dev/errors/418 error due mismatch of last updated time date
• 57e98cd: add Layout#sidebar.defaultOpen prop to configure sidebar default open state
• d586bd6: fix ThemeSwitch#lite prop
• 29a44de: fix regression from Nextra 3 setting theme.collapsed?: boolean in _meta file for folders has no effect in sidebar
• 5e86a14: add missing transition state for <Navbar> links and <TOC> extra content links
• 2ba45de: allow change _meta file theme.toc property with type: 'page'
• Updated dependencies [29a44de]
• Updated dependencies [19578c3]
  • [email protected]

v4.1.0

Compare Source

Minor Changes

• 7caf059: - generate unique anchor id for <summary> elements based on its content at build time
  • add anchor link icon for <summary>

Patch Changes

• fa7f1ee: fix cropped sidebar footer on desktop, when Nextra's <Banner> is used
• Updated dependencies [7caf059]
  • [email protected]

v4.0.9

Compare Source

Patch Changes

• Updated dependencies [e78f796]
• Updated dependencies [ff007b2]
  • [email protected]

v4.0.8

Compare Source

Patch Changes

• Updated dependencies [267ef81]
  • [email protected]

v4.0.7

Patch Changes

• Updated dependencies [32e7d55]
• Updated dependencies [695e428]
• Updated dependencies [fc78033]
• Updated dependencies [b2f2458]
  • [email protected]

v4.0.5

Compare Source

Patch Changes

• Updated dependencies [14bf091]
  • [email protected]

v4.0.4

Compare Source

Patch Changes

• 5132295: fix broken showLineNumbers setting on code blocks
• 5132295: fix unable order _meta key with index name
• Updated dependencies [5132295]
• Updated dependencies [5132295]
  • [email protected]

v4.0.3

Compare Source

v4.0.2

Compare Source

Patch Changes

• 865e2ab: hide On This Page TOC's title themeConfig.toc.title when there is no toc links
  • [email protected]

v4.0.1

Compare Source

Patch Changes

• 481e0d0: fix syntax highlighting for mdx lang and improve docs for /docs/docs-theme/start
• 426cd66: Remove margin-top from .nextra-steps :before pseudo selector
• Updated dependencies [481e0d0]
• Updated dependencies [426cd66]
  • [email protected]

v4.0.0

Compare Source

Nextra 4.0 is just released!

🔹App Router
🔹Turbopack
🔹Compiled by React-Compiler
🔹New Rust-powered search engine Pagefind
🔹RSC i18n
🔹Server/Client components
🔹Smallest bundle size EVER for a Nextra-powered website
🔹GitHub Alert Syntax
🔹New _meta.global file
🔹… and more

Blog post announcement and migration guide.

Please refer to CHANGELOG.md for details.